外观
🎈 想读易懂版？
本章有易懂版（大白话讲重点，10 分钟读完）：[第 1 章 初识 momawork-rs（易懂版）](../../easy/第1章 初识 momawork-rs（易懂版）.md)
第 1 章 初识 momawork-rs
本章目标：5 分钟内建立对 momawork-rs 的完整认知——我是谁、能做什么、不能做什么，以及一次成功的 AI 任务长什么样。学完本章，你就能判断"这件事该不该交给 AI 做"。
1.1 我是谁：一个坐在你电脑里的同事
我是 momawork-rs，一个运行在 MomaWork 桌面程序里的 AI 工作助手。比起"聊天机器人"这个称呼，更准确的比喻是：一个坐在你电脑旁边、能真正动手干活的同事。
普通聊天机器人只会在对话框里输出文字；而我不一样——我拥有和你相同的工作目录，看得见你的文件，改得了你的代码，跑得了你的命令。
1.1.1 我与普通 AI 聊天工具的三个本质区别
| 区别 | 普通聊天工具 | momawork-rs |
|---|---|---|
| 工作环境 | 云端一个隔离的对话框 | 你的真实工作目录，与项目共享文件 |
| 动手能力 | 只能生成文字/图片 | 读写文件、执行命令、运行脚本、调用 Skill |
| 记忆方式 | 每次对话从零开始 | 持久记忆文件，跨会话记得你的偏好与项目背景 |
一句话记住我
聊天机器人给你"建议"，我给你"结果"。 你说"帮我整理这个目录"，我会真的动手整理，而不是告诉你"你应该整理"。
1.1.2 关于我的名字
momawork-rs 中的 rs 代表我的技术底座（Rust 驱动的高性能运行内核）。你不用记住这个名字的含义——在 MomaWork 里，你只需要知道：我是你随时可以召唤的 AI 同事。
1.2 我能做什么：八大核心能力
以下是我的"岗位说明书"——每一项能力都能单独使用，也能组合成复杂的任务流：
| 能力 | 说明 | 典型示例 | 对应章节 |
|---|---|---|---|
| 📄 读写文件 | 创建、编辑、查看项目里的任何文本文件 | 写报告、改配置、读日志 | 第 3 章 |
| ⌨️ 执行命令 | 在 shell 里运行命令、脚本、程序 | 装依赖、跑测试、批量改名 | 第 3 章 |
| 🔍 搜索定位 | 按文件名或内容快速找到目标 | 找函数、搜报错、查文档 | 第 11 章 |
| 🧩 调用 Skill | 加载预设的专业工作方法 | 提交代码、评审 PR、处理 PDF | 第 5、17 章 |
| 🧠 记忆系统 | 持久保存用户与项目上下文 | 记住你的偏好、项目背景、约定 | 第 6、20 章 |
| 📋 计划模式 | 先规划再执行的长任务 | 大重构、多步骤交付 | 第 7 章 |
| 👥 AI 团队 | 多智能体并行协作 | 开发 + 测试 + 文档并行推进 | 第 8、16 章 |
| ⚡ 子代理 | 后台并行处理子任务 | 并行调研、分块生成 | 第 8 章 |
1.2.1 这些能力如何组合
单一能力解决小问题，组合能力解决真问题。例如一个"周报自动化"任务：
你：帮我生成这周的周报
我：
① 搜索定位 → 找出本周修改过的所有文件（第 11 章）
② 读写文件 → 读取每个文件的改动内容
③ 执行命令 → 统计代码量、运行测试确认状态
④ 调用 Skill → 用「周报模板 Skill」按格式输出
⑤ 交付 → 生成 docs/周报-第33周.md，等你检查组合原则
先想清楚"这件事需要哪些能力"，再开口。 你不需要懂技术细节，但描述越接近任务本身，我组合能力就越准。
1.3 一次 AI 任务里到底发生了什么
为了不把 AI 当"魔法"，我们拆开看一次任务的全过程。以下图为例，一次成功的 AI 任务是一个五步协作循环：
1.3.1 五步详解
| 步骤 | 谁 | 做什么 | 你的角色 |
|---|---|---|---|
| ① 描述任务 | 你 | 说清目标、输入、验收标准 | 主演 |
| ② 理解与规划 | 助手 | 读文件、问口径、拆步骤 | 协作 |
| ③ 动手执行 | 助手 | 读写文件、跑命令、调 Skill | 监督 |
| ④ 检查修订 | 你 | 看中间产物、提反馈 | 关键 |
| ⑤ 交付沉淀 | 助手 | 交付物 + 把方法存成 Skill/记忆 | 验收 |
1.3.2 为什么第 ④ 步最关键
统计上，AI 任务翻车最多的环节，不是"AI 能力不够"，而是第 ① 步需求没说清 + 第 ④ 步没有中间检查。
- ❌ 错误示范：
帮我做个 PPT（没有目标、没有素材、没有风格要求） - ✅ 正确示范：
帮我把 docs/项目总结.md 转成一份 10 页的汇报 PPT，风格简洁商务，标题用「Q3 项目复盘」，最后附一页风险清单
重要原则
永远要求"可检查的中间产物"，而不是"直接给最终结论"。 例如改代码前先给我看改动计划；写报告先给我大纲。这样即使出错，损失也可控、可回退。
1.4 我的边界：诚实版"我不能做什么"
了解边界和了解能力同样重要。以下 5 条请你务必记住：
1.4.1 五个边界
| # | 边界 | 具体含义 | 应对方式 |
|---|---|---|---|
| 1 | 我活在工作目录里 | 看不到你整个硬盘，只能访问当前项目及相关路径 | 把需要的文件放进工作目录再让我处理 |
| 2 | 网络访问有限 | 不能随意浏览互联网，除非你提供工具/链接 | 给我下载链接，或把内容贴给我 |
| 3 | 危险操作先确认 | 删除、覆盖、推送远程仓库等不可逆动作，我会先问你 | 收到确认询问时，看清再回答 |
| 4 | 记忆是文件 | 我的记忆存在项目 memory 目录，可查看/修改/删除 | 敏感信息不要写进任务描述 |
| 5 | 我可能出错 | 尤其是数据口径、需求理解上的偏差 | 用"中间产物检查法"控制风险 |
1.4.2 什么任务不适合交给我
- ❌ 需要实时联网浏览的任务（除非接好工具）
- ❌ 需要你签字确认的对外承诺（我只做草稿）
- ❌ 涉及敏感机密的内容（本地环境相对安全，但别把密码写进项目文件）
- ❌ 需要主观判断品味的最终拍板（我可以给建议，决定权在你）
判断口诀
"能检查、可回退、无风险"的任务 → 大胆交给我；反之 → 先做半步试探。
1.5 一次成功的合作长什么样
把前面所有内容浓缩成一个真实场景：
你：写一份《Q3 运营复盘》，数据在 data/ 目录下，用模板 docs/template.md，
重点分析用户增长与留存，最后给出 3 条可执行建议。
我（先规划）：好的，我先读模板和数据 → 确认统计口径（哪个时间范围？留存怎么定义？）
我（再执行）：读取 data/ 全部 4 个文件 → 按模板生成初稿 → 标注 2 处数据口径疑问
你：口径按自然月，留存按次月活跃；第 2 条建议再具体一点
我（修订）：更新口径与建议 → 生成最终版 docs/周报/Q3运营复盘.md → 附数据明细表关键不是"我说了什么漂亮话"，而是每一步都可检查、可回退、有产物。
1.6 你的第一个 60 秒上手
不用读完整个白皮书，现在就试：
- 打开 MomaWork，新建或打开一个项目文件夹；
- 对我说：
你好，介绍一下你自己，以及你现在的工作目录； - 再对我说：
列出当前工作目录里的所有文件，按类型分组展示； - 看看我的回答——这就是你与 AI 同事的第一次协作。
注意
如果第 2、3 步我的回答和你预期不符（比如工作目录不对），立刻告诉我。第一次对话就校准"工作目录"认知，能避免后面 80% 的错乱。
1.7 本章练习
- 判断题：momawork-rs 能直接浏览互联网获取最新新闻吗？（答案：不能，需要你提供链接或工具）
- 组合题：任务"把项目里所有 TODO 注释找出来并汇总成清单"，需要哪些能力组合？
- 实践题：告诉我你最近想解决的一个真实问题，我们一起把它变成第一个任务。
- 边界题：以下哪个任务不适合交给我：A. 批量重命名文件 B. 帮你在微博上自动发言 C. 统计报表数据（答案：B）
小结：我是一台"任务执行器"，不是"聊天机器"。我的能力清单 = 8 项核心能力 × 自由组合；我的工作方式 = 五步协作循环；我的边界 = 5 条诚实清单。你的表达越接近任务（有目标、有输入、有验收标准），我的输出就越接近交付物。 下一章，我们学习如何把需求讲清楚。